파일 또는 디렉터리 복사 (file.copy)
선언
작업 성공 여부, 오류 정보 = file.copy(원본 경로, 대상 경로 [, 모드])
매개변수
- 원본 경로
문자열. 원본 파일 또는 디렉터리의 절대 경로입니다. - 대상 경로
문자열. 복사 후 파일 또는 디렉터리의 전체 절대 경로이며, 대상 파일 이름이나 디렉터리 이름을 포함합니다. - 모드 20250914+
문자열, 선택 사항. 복사 모드이며 값은 다음과 같습니다.- 빈 문자열 또는 생략: 기본 모드(no-clobber). 대상이 이미 있으면 실패를 반환합니다.
- "overwrite" 또는 "o": 덮어쓰기 모드. 기존 대상을 삭제하고 바로 바꿉니다.
- "merge" 또는 "m": 병합 모드(디렉터리에만 사용). 대상에 이미 있는 파일을 유지합니다.
- "overwrite-merge" 또는 "om"/"mo": 덮어쓰기 병합 모드. 디렉터리를 병합하되 이름이 같은 파일은 덮어씁니다.
반환값
- 작업 성공 여부
불리언. 작업에 성공하면 true, 실패하면 false를 반환합니다. - 오류 정보
문자열. 작업 실패 시의 오류 정보입니다.
설명
원본 경로가 가리키는 파일 또는 디렉터리를대상 경로로 지정한 파일 또는 디렉터리로 복사합니다.
이 함수는 “지정한 경로 자체로 복사”하는 동작이며 “지정한 디렉터리 안으로 복사”하는 동작이 아닙니다.대상 경로는 최종 파일 또는 디렉터리를 지정하며, 원본 파일 이름이나 디렉터리 이름을 자동으로 덧붙이지 않습니다. 대상이 이미 존재하는 디렉터리이거나 대상 경로가/로 끝나더라도 원본 파일이나 디렉터리를 그 디렉터리 안에 넣지 않습니다.
예를 들어/a/b/c를 이름c를 유지하여/d/e/안으로 복사하려면 대상 경로를/d/e/c로 지정해야 하며,/d/e/만 지정해서는 안 됩니다.
대상이 이미 있으면모드에 따라 처리합니다. 기본 모드는 실패를 반환하고, 덮어쓰기 모드는 대상 자체를 바꾸며, 디렉터리 병합 모드는 원본 디렉터리 내용을 대상 디렉터리에 병합합니다.
키워드: 파일 복사, 디렉터리 복사, 폴더 복사
이 함수는 20250313 이후 버전에서 사용할 수 있습니다.
예제
ok, err = file.copy(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('복사 실패: '..err)
end
참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 sys.alert를 사용합니다.
이름을 유지하며 다른 디렉터리로 복사하기
-- /d/e는 이미 존재하는 디렉터리이고 /d/e/c는 아직 없다고 가정합니다.
file.copy('/a/b/c', '/d/e/c') -- 올바른 지정: c를 /d/e/c로 복사합니다.
-- 잘못된 지정: 대상은 e 디렉터리 안의 c가 아니라 e 자체입니다.
file.copy('/a/b/c', '/d/e/') -- 기본 모드에서는 대상이 이미 존재하므로 실패합니다.
-- 덮어쓰기 모드는 e 자체를 바꾸며 /d/e/c를 생성하지 않습니다(20250914+).
-- file.copy('/a/b/c', '/d/e/', 'overwrite')
“디렉터리 안으로 복사” 함수 만들기
다음은 사용자 정의 래퍼 함수 예제로, 20250914 이후 버전이 필요합니다. 대상 디렉터리는 이미 존재해야 합니다. 함수는 원본 파일 또는 디렉터리 이름을 유지하며 선택적 mode 매개변수를 file.copy에 전달합니다. 이름이 충돌하면 지정한 모드에 따라 처리합니다.
local function file_copy_into(src_path, dst_dir, mode)
if file.exists(dst_dir) ~= "directory" then
return false, "Target is not a directory"
end
local name, err = file.path.last_component(src_path)
if not name then
return false, err
end
-- 대상 디렉터리 자체나 그 부모 디렉터리가 최종 대상이 되는 것을 방지합니다.
if name == "" or name == "/" or name == "." or name == ".." then
return false, "Source path must end with a file or directory name"
end
local dst_path, path_err = file.path.add_component(dst_dir, name)
if not dst_path then
return false, path_err
end
return file.copy(src_path, dst_path, mode)
end
-- /d/e가 이미 존재하는 디렉터리라고 가정하고 c를 /d/e/c로 복사합니다.
local ok, err = file_copy_into("/a/b/c", "/d/e/")
if not ok then
print("복사 실패: "..err)
end
-- /d/e/c를 바꾸려면 호출 시 덮어쓰기 모드를 지정하세요.
-- file_copy_into("/a/b/c", "/d/e/", "overwrite")
참고: 위 코드는 file.exists, file.path.last_component, file.path.add_component를 사용합니다.